<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>BonoboRunningContext</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="Libbonobo Reference Manual">
<link rel="up" href="general.html" title="General">
<link rel="prev" href="libbonobo-bonobo-main.html" title="bonobo-main">
<link rel="next" href="libbonobo-bonobo-shutdown.html" title="bonobo-shutdown">
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libbonobo-bonobo-main.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="general.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Libbonobo Reference Manual</th>
<td><a accesskey="n" href="libbonobo-bonobo-shutdown.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#libbonobo-bonobo-running-context.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#libbonobo-bonobo-running-context.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="libbonobo-bonobo-running-context"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libbonobo-bonobo-running-context.top_of_page"></a>BonoboRunningContext</span></h2>
<p>BonoboRunningContext — a live object tracker</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="libbonobo-bonobo-running-context.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">                    <a class="link" href="libbonobo-bonobo-running-context.html#BonoboRunningContext" title="BonoboRunningContext">BonoboRunningContext</a>;
                    <a class="link" href="libbonobo-bonobo-running-context.html#BonoboRunningContextClass" title="BonoboRunningContextClass">BonoboRunningContextClass</a>;
<a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="returnvalue">BonoboObject</span></a> *      <a class="link" href="libbonobo-bonobo-running-context.html#bonobo-running-context-new" title="bonobo_running_context_new ()">bonobo_running_context_new</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libbonobo-bonobo-running-context.html#bonobo-running-context-ignore-object" title="bonobo_running_context_ignore_object ()">bonobo_running_context_ignore_object</a>
                                                        (<em class="parameter"><code><span class="type">CORBA_Object</span> object</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libbonobo-bonobo-running-context.html#bonobo-running-context-at-exit-unref" title="bonobo_running_context_at_exit_unref ()">bonobo_running_context_at_exit_unref</a>
                                                        (<em class="parameter"><code><span class="type">CORBA_Object</span> object</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="libbonobo-bonobo-running-context.description"></a><h2>Description</h2>
<p>
    <a class="link" href="libbonobo-bonobo-running-context.html#BonoboRunningContext" title="BonoboRunningContext"><span class="type">BonoboRunningContext</span></a> implements the
    <code class="classname">Bonobo::RunningContext</code> IDL interface,
    depicted in <a class="xref" href="libbonobo-bonobo-running-context.html#running-context-img" title="Figure 1. The Bonobo::RunningContext interface">Figure 1, “The Bonobo::RunningContext interface”</a>.
</p>
<div class="figure">
<a name="running-context-img"></a><p class="title"><b>Figure 1. The Bonobo::RunningContext interface</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="running-context.png" alt="The Bonobo::RunningContext interface"></div></div>
</div>
<br class="figure-break"><p>
    The purpose of this object is to keep track of currently running
    objects.  This is useful in, for example, exe type factories, in
    order to know when it is safe to quit from the main loop.
</p>
<p>
    <a class="link" href="libbonobo-bonobo-running-context.html#BonoboRunningContext" title="BonoboRunningContext"><span class="type">BonoboRunningContext</span></a> is a singleton.  There is at most one
    instance running at all times.  All <a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="type">BonoboObject</span></a>'s are
    automatically registered with the running context as part of their
    normal initialization procedure.
</p>
<p>
    To find out when all objects have been destroyed, just connect a
    handler to the "last-unref" signal.
</p>
</div>
<div class="refsect1">
<a name="libbonobo-bonobo-running-context.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="BonoboRunningContext"></a><h3>BonoboRunningContext</h3>
<pre class="programlisting">typedef struct {
	BonoboObject parent;

	BonoboRunningContextPrivate *priv;
} BonoboRunningContext;
</pre>
<p>
the running context data
</p>
</div>
<hr>
<div class="refsect2">
<a name="BonoboRunningContextClass"></a><h3>BonoboRunningContextClass</h3>
<pre class="programlisting">typedef struct {
	BonoboObjectClass parent;

	POA_Bonobo_RunningContext__epv epv;

	void (*last_unref) (void);
} BonoboRunningContextClass;
</pre>
<p>
the running context class
</p>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-running-context-new"></a><h3>bonobo_running_context_new ()</h3>
<pre class="programlisting"><a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="returnvalue">BonoboObject</span></a> *      bonobo_running_context_new          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-running-context-ignore-object"></a><h3>bonobo_running_context_ignore_object ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_running_context_ignore_object
                                                        (<em class="parameter"><code><span class="type">CORBA_Object</span> object</code></em>);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-running-context-at-exit-unref"></a><h3>bonobo_running_context_at_exit_unref ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_running_context_at_exit_unref
                                                        (<em class="parameter"><code><span class="type">CORBA_Object</span> object</code></em>);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="libbonobo-bonobo-running-context.see-also"></a><h2>See Also</h2>
<p>
    <a class="xref" href="libbonobo-bonobo-generic-factory.html" title="BonoboGenericFactory"><span class="refentrytitle"><a name="libbonobo-bonobo-generic-factory.top_of_page"></a>BonoboGenericFactory</span>(3)</a>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.15.1</div>
</body>
</html>